Ugrás a fő tartalomhoz

Státusz lekérdezése pollozással – query

A fizetési kérelem elküldése után a státusz pollozással kérdezhető le. Az rtpQuery végpont visszaadja a kérelem aktuális állapotát és a hozzá tartozó részleteket. A státuszt addig érdemes ismételten lekérdezni, amíg az végstátuszba (ACCP vagy RJCT) nem kerül.

Működés leírása​

Az RTP státusz lekérdezés (rtpQuery) az alábbi lépésekben zajlik:

  1. A beérkező kérelem validálása – az instructionIdentification vagy az endToEndIdentification megadása kötelező.
  2. Jogosultság-ellenőrzés.
  3. Cache ellenőrzés: ha az instructionId + endToEndId párhoz érvényes cache bejegyzés létezik, a tárolt válasz kerül visszaadásra.
  4. Ha nincs cache-találat: jogosultság ellenőrzés, majd a háttérrendszer válaszát cache-eli (ha az jogosult rá, ld. alább).
  5. Válasz visszaküldése.

Cache-be kerülés feltételei​

Egy válasz nem kerül gyorsítótárba, ha a válaszban bármely kérelem státusza ACTC (feldolgozás alatt).

Egyébként két eset lehetséges:

Van jövőbeli lejárati időpont: a válasz csak akkor kerül cache-be, ha a legközelebbi jövőbeli lejárat legalább 1 óra múlva esedékes.

A kérésben szereplő lejárati időpont múltbeli, de a státusz nem végstátusz: a válasz mégis mentésre kerül egy fallback lejárattal, hogy az ütemező később frissíthesse a háttérrendszerből.

Ha minden kérelem státusza végstátusz (ACCP – elfogadott, vagy RJCT – visszautasított), a bejegyzés nem kap frissítési időpontot – az ütemező kihagyja.

Cache frissítési ütemezés​

A háttérben futó ütemező 5 percenként ellenőrzi az esedékes frissítéseket. A következő frissítés időpontját két különböző logika határozza meg:

Ha van jövőbeli lejárati időpont (lejáratig hátralévő idő alapján):

Lejáratig hátralévő időKövetkező frissítés
Több mint 12 óra12 óra múlva
1–12 óra között1 óra múlva
Kevesebb mint 1 óra15 perc múlva

Ha lejárt (napszak alapján):

Jelenlegi napszakKövetkező frissítés
Éjjel (04:00 előtt)Aznap 04:00-kor
Reggel–este (04:00–17:00)10 percenként
Este (17:00 után)Másnap 04:00-kor

A lejárt bejegyzések törlése naponta egyszer, éjjel 2-kor történik.

Mintahívás:

request
{
    "paymentRequestData": {
    	"endToEndIdentification": "UBRTHUH0___-20260220-FKHB0000083449",
        "instructionIdentification": "RP280924605496124080000"
    }
}

Response:

response
{
    "paymentRequestStatus": {
        "statusIdentification": "56B0500BB2E31AEDA6F20004AC1F691F",
        "creationDateTime": "2026-02-13T12:55:27.492Z",
        "paymentRequests": [
            {
                "originalPaymentInformationIdentification": "RP809644136783965",
                "expiryDateTime": "2026-02-15T12:53:07.74Z",
                "originalInstructionIdentification": "RP503699598159500100000",
                "originalEndToEndIdentification": "UBRTHUH0___-20260213-FKHB0000042487",
                "transactionStatus": "ACWP",
                "instructionPriority": "HIGH",
                "instructedAmount": {
                    "currency": "HUF",
                    "amount": "100"
                },
                "amountModificationAllowed": "false",
                "categoryPurpose": {
                    "categoryPurposeCode": "EPAY"
                },
                "ultimateDebtorName": "012sdfoisjdfúőfadsfoaisdfmo34m4i_mpadjfnsdf? skdjfnisuf23jnfjf jsdfjn4",
                "ultimateDebtorIdentification": {
                    "identificationType": "ORG-OTHR",
                    "identification": "1111 /-?:().,'+abcdoABCDO0123456789"
                },
                "debtorName": "985sdfoisjdfúőfadsfoaisdfmo34m4i_mpadjfnsdf? skdjfnisuf23jnfjf jsdfjn4",
                "debtorAddress": {
                    "country": "HU",
                    "address": "012sdfoisjdfúőfadsfoaisdfmo34m4i_mpadjfnsdf? skdjfnisuf23jnfjf jsdfjn4"
                },
                "debtorIdentification": {
                    "identificationType": "ORG-OTHR",
                    "identification": "2222 /-?:().,'+abcdoABCDO0123456789"
                },
                "debtorAccount": {
                    "iban": "HU77120836000041718100100009"
                },
                "creditorIdentification": {
                    "identificationType": "ORG-OTHR",
                    "identification": "0000 /-?:().,'+abcdoABCDO0123456789"
                },
                "creditorAccount": {
                    "iban": "HU91120113510184523800100006"
                },
                "ultimateCreditorName": "888sdfoisjdfúőfadsfoaisdfmo34m4i_mpadjfnsdf? skdjfnisuf23jnfjf jsdfjn4",
                "ultimateCreditorIdentification": {
                    "identificationType": "ORG-OTHR",
                    "identification": "3333 /-?:().,'+abcdoABCDO0123456789"
                },
                "regulatoryReporting": {
                    "shopIdentification": "Postman_Test",
                    "merchDeviceIdentification": "4703",
                    "invoiceIdentification": "invKépzőművésze 2023! @#%&- áéöőúüű",
                    "customerIdentification": "cusKépzőművésze 2023! @#%&- áéöőúüű",
                    "credTranIdentification": "RP564540255150700824941939176209161",
                    "loyaltyIdentification": "loyKépzőművésze 2023! @#%&- áéöőúüű",
                    "navCheckIdentification": "navKépzőművésze 2023! @#%&- áéöőúüű",
                    "latestDateTime": "2026-02-14T12:53:07.72Z"
                },
                "remittanceInformationUnstructured": "01AÁÉÍÓÖŐOÚÜŰaáéiíoóöőúüűa23456789L01]#$%&()+,-./;:?@\\_{}! AÁ23456789L01AÁÉÍÓÖŐOÚÜŰaáéiíoóöőúüűa23456789L01]#$%&()+,-./;:?@\\_{}! AÁ23456789L",
                "remittanceInformationStructured": {
                    "reference": "01AÁÉÍÓÖŐOÚÜŰaáéiíoóöőúüűa23456789L",
                    "referenceType": "SCOR",
                    "referenceIssuer": "02AÁÉÍÓÖŐOÚÜŰaáéiíoóöőúüűa23456789L"
                }
            }
        ]
    }
}

RTP státuszok jelentése

Státusz kódStátusz leírásVan-e mellette reason
ACCPFizetveNincs
ACSCA tétel az indító számlán teljesítveNincs
ACTCA tétel formai ellenőrzése sikeresNincs
ACWPFizető fél jóváhagyására várNincs
RCVDA tétel beérkezettNincs
RJCTA tétel tételei visszautasításra kerültekVan

A RJTC státuszhoz tartozó reason kódok

Reason kódHelye Cd/PrtryReason leírás
AB02CdTechnikai hiba
AC01CdFizetési kérelmet küldő számlaszáma hibás vagy hiányzik
AC02CdFizető fél számlaszáma érvénytelen vagy hiányzik
AC03CdFizetés kérelmet küldő számlaszáma érvénytelen vagy hiányzik
AC06CdFizető fél számlája zárolva van
AC07CdFizetés kérelmet küldő számlaszáma bezárt
AC09CdA számla devizaneme érvénytelen vagy hiányzik
AG01CdEz a tranzakció nem megengedett a számlatípuson
AG03CdEz tranzakció típus nem engedélyezett ezen a számlán
AM01CdAz összeg értéke nulla
AM02CdAz összeg magasabb a megengedett értéknél
AM03CdA megadott devizanem nem engedélyezett
AM05CdDuplikált tranzakció
AM06CdAz összeg alacsonyabb a megengedettnél
AM12CdAz összeg érvénytelen vagy hiányzik
AM14CdTranzakció összege meghaladja a megengedett összeget
AM21CdTranzakció összege meghaladja a megengedett összeget
BE04CdKedvezményezett címe hiányzik vagy hibás
BE08CdFizető fél neve nincs kitöltve
BE16CdÉrvénytelen (tényleges) fizető fél azonosító
BE17CdÉrvénytelen (tényleges) kedvezményezett azonosító
BE21CdHiányzó vagy érvénytelen név a csomagban
BE22CdKedvezményezett neve nincs megadva
CH20CdTizedesek száma nem megfelelő a devizanemhez
CH21CdKötelező mező nincs töltve
CNORCdKedvezményezett bank BIC kódja nem regisztrált
CURRCdÁtutalás devizaneme érvénytelen
CUSTCdFizető fél által visszautasított
DS02CdTörölt megbízás
DS0HCdÉrvénytelen aláírás
DS24CdLejárt
DSR0CPrtryNem megfelelő bejövő üzenet visszautasításra került
DSR23PrtryÉrvénytelen jogcím kód
DSR45PrtryNumerikus mező hiba
DSR61PrtryFizető fél és kedvezményezett számlaszáma azonos
DSR71PrtrySzámlaszám nem IBAN formátumú
DSRF1PrtryMásodlagos számlaazonosító nem engedélyezett ehhez a tranzakció típushoz
DSRF2PrtryMásodlagos számlaazonosító ellenőrzése sikertelen
DSRF3PrtryHibás másodlagos számlaazonosító
DSRF4PrtryTöbb másodlagos számlaazonosító került megadásra
DSRF5PrtrySzámlaazonosító és számlaszám is meg lett adva
DSRG1PrtryA kedvezményezett bankja nem elérhető
DSRG6PrtryGIRO vagy Kedvezményezett bank visszautasította
DSRGEPrtryFizető fél bankja visszautasította
DSRGFPrtryEz tranzakció típus nem engedélyezett a kedvezményezett számlán
DSRR1PrtryCímzett Bank nem indíthat AFR utalást
DSRR8PrtryÉrvénytelen érvényességi dátum
DSRR9PrtryÉrvénytelen fizetési határidő
DT01CdElszámolás dátuma érvénytelen vagy hiányzik
DUPLCdDuplikált tranzakció
ED05CdElszámolás sikertelen
FF05CdMező kitöltési hiba
FF06CdJogcím kategória hiba
FF07CdJogcím hiba
FF08CdPartnerek közötti egyedi azonosító hiányzik vagy érvénytelen
FF10CdTechnikai hiba
HSR41PrtryÉrtéknapra vár
HSR45PrtryCsomagban számformátum hiba
HSR47PrtryA köteg feldolgozás alatt
RC03CdCímzett szolgáltató nem fiz kérelem szolgáltató
RR02CdA küldő nevét és/vagy címét kötelező megadni
RR04CdSzabályozási okból visszautasítva
RR07CdKözlemény struktúra hiba
RR09CdHibás kedvezményezett azonosító narratívban
SL02CdVisszahívott
TM01CdBeadási határidő túllépés

RTP átmenetek

ÁtmenetLeírásMagyarázat
indítás → RJCTA fizetési kérelem valamilyen hiba, ami lehet adatbeviteli hiányosság, bank oldali technikai hibahibásan megadott adat, nem létező számla, stb.
indítás → ACTCA fizetési kérelmet a bank háttér rendszere átvette, de a fizetési kérelem feldolgozása még nem jutott el odáig, hogy a fizető fél szolgáltatója a fizetési kérelem kézhezvételét igazolta volnaa másik bank még nem igazolta vissza, hogy megkapta
ACTC → RJCTA fizetési kérelem valamilyen hiba, ami lehet adatbeviteli hiányosság, bank oldali technikai hiba, GIRO oldali technikai hiba, fogadó oldali üzleti vagy technikai hibanem sikerült átküldeni a másik bankba vagy a másik bank visszautasította
ACTC → ACWPA fizető fél szolgáltatója a fizetési kérelem kézhezvételét igazolta, az a fizető fél jóváhagyására vagy elutasítására vára fizető félre várunk, hogy jóváhagyja vagy elutasítsa
ACWP → RJCTFizető fél visszautasította a fizetési kérelmet
vagy
Fizetési kérelem érvényessége lejárt		Nem a lejárat pillanatában történik a váltás, hanem egy hajnalban futó karbantartó batch job során
ACWP → ACCPSikeresen kifizetve
* ACTC → ACCPSikeresen kifizetveez valójában egy ACTC → ACWP → ACCP átmenet sorozatot jelent, de abban az időintervallumban amikor épp ACWP volt a státusz, akkor nem történt státusz lekérdezés, így látszólagosan ACTC→ ACCP átmenetnek tűnik

Folyamatábra